Inside Macintosh: QuickDraw GX Objects /

Chapter 6 - Transform Objects / Transform Objects Reference

Functions / Creating and Manipulating Transform Objects

GXNewTransform

You can use the GXNewTransform function to create a new transform object with default properties.

gxTransform GXNewTransform(void);

function result

A reference to the newly created transform object.

DESCRIPTION

The GXNewTransform function creates a transform object with an owner count of 1.
All other properties of the transform are set to their default values:

• A clip that is a full shape.
• A mapping that is the identity mapping.
• A shape-parts mask specifying gxBoundsPart only, and a tolerance of 0.
• A view port list containing a single view port covering all onscreen view devices.
• The owner count is 1.
• The tag list is empty.

SPECIAL CONSIDERATIONS

If no error occurs, the GXNewTransform function creates a transform object; you are responsible for disposing of that object when you no longer need it.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory

SEE ALSO

For an example of the use of this function, see Listing 6-1 on page 6-16.

Default transform properties are described in the section "Default Transform Objects" beginning on page 6-14. For general information on the properties of transform objects, see "Transform Object Properties" beginning on page 6-6.

To dispose of a transform object, use the GXDisposeTransform function, which is described in the next section.

To create a transform object that is identical to an existing one, use the GXCopyToTransform function, described on page 6-35.